home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
u_man
/
cat1
/
X11
/
xlock.z
/
xlock
Wrap
Text File
|
1998-10-20
|
21KB
|
397 lines
XXXXLLLLOOOOCCCCKKKK((((1111)))) IIIIrrrriiiixxxx ((((00006666 JJJJuuuunnnn 1111999999991111)))) XXXXLLLLOOOOCCCCKKKK((((1111))))
NNNNAAAAMMMMEEEE
xlock - Locks the local X display until a password is
entered.
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
xxxxlllloooocccckkkk [ ----ddddiiiissssppppllllaaaayyyy dsp ] [ ----hhhheeeellllpppp ] [ ----rrrreeeessssoooouuuurrrrcccceeeessss ]
[ ----bbbbllllaaaannnnkkkktttthhhhrrrreeeesssshhhh num ] [ ----////++++rrrreeeemmmmooootttteeee ] [ ----////++++mmmmoooonnnnoooo ]
[ ----////++++nnnnoooolllloooocccckkkk ] [ ----////++++aaaalllllllloooowwwwrrrrooooooootttt ] [ ----////++++bbbbeeeessssaaaavvvveeeerrrr ]
[ ----////++++aaaalllllllloooowwwwaaaacccccccceeeessssssss ] [ ----////++++eeeecccchhhhooookkkkeeeeyyyyssss ] [ ----////++++vvvv ]
[ ----////++++uuuusssseeeeffffiiiirrrrsssstttt ] [ ----ddddeeeellllaaaayyyy usecs ] [ ----bbbbaaaattttcccchhhhccccoooouuuunnnntttt num ]
[ ----ccccoooolllloooorrrrccccoooouuuunnnntttt num ] [ ----nnnniiiicccceeee level ]
[ ----ttttiiiimmmmeeeeoooouuuutttt seconds ] [ ----ssssaaaattttuuuurrrraaaattttiiiioooonnnn value ]
[ ----ffffoooonnnntttt fontname ] [ ----bbbbgggg color ] [ ----ffffgggg color ]
[ ----mmmmooooddddeeee mode ] [ ----nnnnaaaammmmeeee textstring ]
[ ----ppppaaaasssssssswwwwoooorrrrdddd textstring ] [ ----iiiinnnnffffoooo textstring ]
[ ----vvvvaaaalllliiiiddddaaaatttteeee textstring ] [ ----iiiinnnnvvvvaaaalllliiiidddd textstring ]
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
xxxxlllloooocccckkkk blanks (or otherwise saves) the screen and possibly
locks the X server till the user enters their password at
the keyboard. While xxxxlllloooocccckkkk is has the screen locked, all new
server connections are refused. The screen saver is
disabled. The mouse cursor is turned off. The screen is
blanked and a changing pattern is put on the screen. If a
key or a mouse button is pressed then the user is prompted
for the password of the user who started xxxxlllloooocccckkkk....
If the correct password is typed, then the screen is
unlocked and the X server is restored. When typing the
password Control-U and Control-H are active as kill and
erase respectively. To return to the locked screen, click
in the small icon version of the changing pattern.
If the screen is merely saved, but not locked, or if the
user who started the program does not have a password, then
no password is required.
OOOOPPPPTTTTIIIIOOOONNNNSSSS
----ddddiiiissssppppllllaaaayyyy ddddsssspppp
The _d_i_s_p_l_a_y option sets the X11 display to lock. xxxxlllloooocccckkkk
locks all available screens on a given server, and
restricts you to locking only a local server such as
uuuunnnniiiixxxx::::0000,,,, llllooooccccaaaallllhhhhoooosssstttt::::0000,,,, or ::::0000 unless you set the ----rrrreeeemmmmooootttteeee
option.
----mmmmooooddddeeee mmmmooooddddeeeennnnaaaammmmeeee
As of this writing there are ten display modes
supported (plus one more for random selection of one of
the ten).
Page 1 (printed 4/30/98)
XXXXLLLLOOOOCCCCKKKK((((1111)))) IIIIrrrriiiixxxx ((((00006666 JJJJuuuunnnn 1111999999991111)))) XXXXLLLLOOOOCCCCKKKK((((1111))))
bbbbllllaaaannnnkkkk Blank mode shows nothing but a black screen.
rrrroooottttoooorrrr Rotor mode shows a swirling rotorlike thing.
ppppyyyyrrrroooo Pyro mode shows lots of small fireworks.
ffffllllaaaammmmeeee Flame mode shows wierd but cool cosmic flame
fractals.
hhhhoooopppp Hop mode shows the "real plane fractals" from the
September 1986 issue of Scientific American.
iiiimmmmaaaaggggeeee Image mode shows several sgi logos randomly
appearing on the screen.
lllliiiiffffeeee Life mode shows Conway's game of life.
ppppoooopppp Pop mode shows single large fireworks exploding on
the screen.
qqqqiiiixxxx Qix mode shows the spinning lines similar to the old
video game by the same name.
sssswwwwaaaarrrrmmmm Swarm mode shows a swarm of bees following a wasp.
rrrraaaannnnddddoooommmm Selects one of the above modes randomly.
----ddddeeeellllaaaayyyy uuuusssseeeeccccssss
The _d_e_l_a_y option sets the speed at which a mode will
operate. It simply sets the number of microseconds to
delay between batches of "hopalong pixels", "qix
lines", "life generations", "image blits", and "pop or
swarm motions". In blank mode, it is important to set
this to some small number of seconds, because the
keyboard and mouse are only checked after each delay,
so you cannot set the delay too high, but a delay of
zero would needlessly consume cpu checking for mouse
and keyboard input in a tight loop, since blank mode
has no work to do.
----bbbbaaaattttcccchhhhccccoooouuuunnnntttt nnnnuuuummmm
The _b_a_t_c_h_c_o_u_n_t option sets the number of _t_h_i_n_g_s to do
per batch to _n_u_m . In qix mode this refers to the
number of lines rendered in the same color. In life
mode it is the number of generations to let each
species live. In hop mode this refers to the number of
pixels rendered in the same color. In image mode this
refers to the number of sgilogos on screen at once. In
swarm mode this refers to the number of bees. In rotor
mode it is the number of rotor thingys which whirr...
In pyro mode it is the maximum number flying rockets at
Page 2 (printed 4/30/98)
XXXXLLLLOOOOCCCCKKKK((((1111)))) IIIIrrrriiiixxxx ((((00006666 JJJJuuuunnnn 1111999999991111)))) XXXXLLLLOOOOCCCCKKKK((((1111))))
one time. In flame mode it is the number of levels to
recurse (larger = more complex). In pop mode this sets
the maximum number of sparks in a burst (the actual
number of sparts in any one burst is chosen randomly).
In blank mode it means nothing.
----ccccoooolllloooorrrrccccoooouuuunnnntttt nnnnuuuummmm
The _c_o_l_o_r_c_o_u_n_t option sets the number of colors to use
to _n_u_m .
----nnnniiiicccceeee nnnniiiicccceeeelllleeeevvvveeeellll
The _n_i_c_e option sets system nicelevel of the xlock
process to _n_i_c_e_l_e_v_e_l .
----ttttiiiimmmmeeeeoooouuuutttt sssseeeeccccoooonnnnddddssss
The _t_i_m_e_o_u_t option sets the number of _s_e_c_o_n_d_s before
the password screen will time out.
----ssssaaaattttuuuurrrraaaattttiiiioooonnnn vvvvaaaalllluuuueeee
The _s_a_t_u_r_a_t_i_o_n option sets saturation of the color ramp
used to _v_a_l_u_e . 0 is grayscale and 1 is very rich
color. 0.4 is a nice pastel.
----ffffoooonnnntttt ffffoooonnnnttttnnnnaaaammmmeeee
The _f_o_n_t option sets the font to be used on the prompt
screen.
----ffffgggg ccccoooolllloooorrrr
The _f_g option sets the color of the text on the
password screen to _c_o_l_o_r .
----bbbbgggg ccccoooolllloooorrrr
The _b_g option sets the color of the background on the
password screen to _c_o_l_o_r .
----nnnnaaaammmmeeee tttteeeexxxxttttssssttttrrrriiiinnnngggg
_t_e_x_t_s_t_r_i_n_g is shown in front of user name, defaults to
"Name: ".
----ppppaaaasssssssswwwwoooorrrrdddd tttteeeexxxxttttssssttttrrrriiiinnnngggg
_t_e_x_t_s_t_r_i_n_g is the password prompt string, defaults to
"Password: ".
----iiiinnnnffffoooo tttteeeexxxxttttssssttttrrrriiiinnnngggg
_t_e_x_t_s_t_r_i_n_g is an informational message to tell the user
what to do, defaults to "Enter password to unlock;
select icon to lock.".
----vvvvaaaalllliiiiddddaaaatttteeee _t_e_x_t_s_t_r_i_n_g
_t_e_x_t_s_t_r_i_n_g ----vvvvaaaalllliiiiddddaaaatttteeee _m_e_s_s_a_g_e _s_h_o_w_n _w_h_i_l_e _v_a_l_i_d_a_t_i_n_g _t_h_e
_p_a_s_s_w_o_r_d, _d_e_f_a_u_l_t_s _t_o "Validating login..."
Page 3 (printed 4/30/98)
XXXXLLLLOOOOCCCCKKKK((((1111)))) IIIIrrrriiiixxxx ((((00006666 JJJJuuuunnnn 1111999999991111)))) XXXXLLLLOOOOCCCCKKKK((((1111))))
----iiiinnnnvvvvaaaalllliiiidddd _t_e_x_t_s_t_r_i_n_g
_t_e_x_t_s_t_r_i_n_g ----iiiinnnnvvvvaaaalllliiiidddd _m_e_s_s_a_g_e _s_h_o_w_n _w_h_e_n _p_a_s_s_w_o_r_d _i_s
_i_n_v_a_l_i_d, _d_e_f_a_u_l_t_s _t_o "Invalid login."
----rrrreeeessssoooouuuurrrrcccceeeessss
The _r_e_s_o_u_r_c_e_s option prints the default resource file
for xlock to standard output.
----////++++rrrreeeemmmmooootttteeee
The _r_e_m_o_t_e option tells xlock to not stop you from
locking remote X11 servers. This option should be used
with care and is intended mainly to lock X11 terminals
which cannot run _x_l_o_c_k locally. If you lock someone
else's workstation, they will have to know yyyyoooouuuurrrr
password to unlock it.
----////++++mmmmoooonnnnoooo
The _m_o_n_o option causes xlock to display monochrome,
(black and white) pixels rather than the default
colored ones on color displays
----////++++nnnnoooolllloooocccckkkk
The _n_o_l_o_c_k option causes xlock to only draw the
patterns and not lock the display. A keypress or a
mouse click will terminate the screen saver or send it
back into the background (with ----bbbbeeeessssaaaavvvveeeerrrr).
----////++++aaaalllllllloooowwwwrrrrooooooootttt
The _a_l_l_o_w_r_o_o_t option allows the root password to unlock
the server as well as the user who started xlock.
----////++++eeeennnnaaaabbbblllleeeessssaaaavvvveeeerrrr
By default xlock will disable the normal X server's
screen saver since it is in effect a replacement for
it. Since it is possible to set delay parameters long
enough to cause phosphor burn on some displays, this
option will turn back on the default screensaver which
is very careful to keep most of the screen black.
----////++++bbbbeeeessssaaaavvvveeeerrrr
If your X server supports the SCREEN-SAVER protocol,
then this option will tell xlock to act as the screen
saver. When you use xlock in this mode, it will not
lock the screen immediately. Instead, when the server
decides the screen should be blanked, it will notify
xlock instead of merely blanking the screen. Xlock
will then display whatever display mode you have
selected.
In this mode, xlock will not exit when you type in a
password. Instead, its window will disappear, and it
Page 4 (printed 4/30/98)
XXXXLLLLOOOOCCCCKKKK((((1111)))) IIIIrrrriiiixxxx ((((00006666 JJJJuuuunnnn 1111999999991111)))) XXXXLLLLOOOOCCCCKKKK((((1111))))
will wait for the next screen saver time out.
This option forces ----eeeennnnaaaabbbblllleeeessssaaaavvvveeeerrrr....
----bbbbllllaaaannnnkkkktttthhhhrrrreeeesssshhhh _n_u_m
Whenever xlock is displaying some graphic mode and the
system load rises over this value, xlock will switch to
blank mode. Since blank mode is much less expensive
than many of the graphic modes, this will allow time
for other system activity.
----////++++aaaalllllllloooowwwwaaaacccccccceeeessssssss
This option is required for servers which do not allow
clients to modify the host access control list. It is
also useful if you need to run x clients on a server
which is locked for some reason... When allowaccess is
true, the X11 server is left open for clients to attach
and thus lowers the inherent security of this
lockscreen. A side effect of using this option is that
if xlock is killed -KILL, the access control list is
not lost.
----////++++eeeecccchhhhooookkkkeeeeyyyyssss
The _e_c_h_o_k_e_y_s option causes xlock to echo '?' characters
for each key typed into the password prompt. Some
consider this a security risk, so the default is to not
echo anything.
----////++++uuuusssseeeeffffiiiirrrrsssstttt
The _u_s_e_f_i_r_s_t option causes xlock to use the keystroke
which got you to the password screen as the first
character in the password. The default is to ignore
the first key pressed.
----vvvv Verbose mode, tells what options it is going to use.
BBBBUUUUGGGGSSSS
"kill -KILL xxxxlllloooocccckkkk " causes the server that was locked to be
unusable, since all hosts (including localhost) were removed
from the access control list to lock out new X clients, and
since xlock couldn't catch SIGKILL, it terminated before
restoring the access control list. This will leave the X
server in a state where "_y_o_u _c_a_n _n_o _l_o_n_g_e_r _c_o_n_n_e_c_t _t_o _t_h_a_t
_s_e_r_v_e_r, _a_n_d _t_h_i_s _o_p_e_r_a_t_i_o_n _c_a_n_n_o_t _b_e _r_e_v_e_r_s_e_d _u_n_l_e_s_s _y_o_u
_r_e_s_e_t _t_h_e _s_e_r_v_e_r." -From the X11R4 Xlib
Documentation, Chapter 7.
On some kernel and hardware combinations, ppppoooopppp mode will
cause trashy flickering at the top of the screen. This is a
bug in the graphics library/kernel/hardware (depending on
how you look at it) and is out of xxxxlllloooocccckkkk's control.
Page 5 (printed 4/30/98)
XXXXLLLLOOOOCCCCKKKK((((1111)))) IIIIrrrriiiixxxx ((((00006666 JJJJuuuunnnn 1111999999991111)))) XXXXLLLLOOOOCCCCKKKK((((1111))))
NNNNOOOOTTTTEEEE
If you run xxxxlllloooocccckkkk on a machine not running the kernel in
/unix, you can potentially confuse xxxxlllloooocccckkkk since it will not
be able to measure the load correctly. If the load appears
too far out of range, xxxxlllloooocccckkkk will print a message to that
affect and disable the load threshold checking.
SSSSEEEEEEEE AAAALLLLSSSSOOOO
X(1), xset(1), Xlib Documentation.
AAAAUUUUTTTTHHHHOOOORRRR
Patrick J. Naughton (naughton@eng.sun.com)
Mailstop 10-20
Sun Laboratories, Inc.
Mountain View, CA 94043
415/336-1080
CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
Copyright (c) 1988-91 by Patrick J. Naughton
Permission to use, copy, modify, and distribute this
software and its documentation for any purpose and without
fee is hereby granted, provided that the above copyright
notice appear in all copies and that both that copyright
notice and this permission notice appear in supporting
documentation.
Page 6 (printed 4/30/98)